home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / underlay.z / underlay
Encoding:
Text File  |  2002-10-03  |  6.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. uuuunnnnddddeeeerrrrllllaaaayyyy((((3333GGGG))))                                                      uuuunnnnddddeeeerrrrllllaaaayyyy((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      uuuunnnnddddeeeerrrrllllaaaayyyy - allocates bitplanes for display of underlay colors
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd uuuunnnnddddeeeerrrrllllaaaayyyy((((ppppllllaaaannnneeeessss))))
  13.      lllloooonnnngggg ppppllllaaaannnneeeessss;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_l_a_n_e_s   expects the number of bitplanes to be allocated for underlay
  17.               colors.  Valid values are 0 (the default), 2, 4, and 8.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The IRIS physical framebuffer is divided into four separate GL
  21.      framebuffers:  normal, popup, overlay, underlay.  Because a single
  22.      physical framebuffer is used to implement the four GL framebuffers,
  23.      bitplanes must be allocated among the GL framebuffers.  uuuunnnnddddeeeerrrrllllaaaayyyy
  24.      specifies the number of bitplanes to be allocated to the underlay
  25.      framebuffer.  uuuunnnnddddeeeerrrrllllaaaayyyy does not take effect immediately.  Rather, it is
  26.      considered only when ggggccccoooonnnnffffiiiigggg is called, at which time all requests for
  27.      bitplane resources are resolved.
  28.  
  29.      While only one of the four GL framebuffers can be drawn to at a time (see
  30.      ddddrrrraaaawwwwmmmmooooddddeeee), all four are displayed simultaneously.  The decision of which
  31.      to display at each pixel is made based on the contents of the four
  32.      framebuffers at that pixel location, using the following hierarchical
  33.      rule:
  34.  
  35.      _i_f           the popup pixel contents are non-zero
  36.  
  37.      _t_h_e_n         display the popup bitplanes
  38.  
  39.      _e_l_s_e _i_f      overlay bitplanes are allocated AND
  40.                   the overlay pixel contents are non-zero
  41.  
  42.      _t_h_e_n         display the overlay bitplanes
  43.  
  44.      _e_l_s_e _i_f      the normal pixel contents are non-zero OR
  45.                   no underlay bitplanes are allocated
  46.  
  47.      _t_h_e_n         display the normal bitplanes
  48.  
  49.      _e_l_s_e         display the underlay bitplanes
  50.  
  51.      Thus images drawn into the overlay framebuffer appear over images in the
  52.      normal framebuffer, and images drawn into the underlay framebuffer appear
  53.      under images in the normal framebuffer.  Popup images appear over
  54.      everything else.
  55.  
  56.      The default configuration of the underlay framebuffer is 0 bitplanes.  To
  57.      make a change to this configuration other than to change the bitplane
  58.      size, the drawing mode must be UUUUNNNNDDDDEEEERRRRDDDDRRRRAAAAWWWW.  For example, the underlay
  59.      framebuffer can be configured to be double buffered by calling
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uuuunnnnddddeeeerrrrllllaaaayyyy((((3333GGGG))))                                                      uuuunnnnddddeeeerrrrllllaaaayyyy((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      ddddoooouuuubbbblllleeeebbbbuuuuffffffffeeeerrrr while draw mode is UUUUNNNNDDDDEEEERRRRDDDDRRRRAAAAWWWW.
  75.  
  76.      On models that cannot support overlay and underlay bitplanes
  77.      simultaneously, calling uuuunnnnddddeeeerrrrllllaaaayyyy with a non-zero argument forces oooovvvveeeerrrrllllaaaayyyy
  78.      to zero.  When simultaneous overlay and underlay operation is supported,
  79.      calling uuuunnnnddddeeeerrrrllllaaaayyyy may have no effect on the number of overlay bitplanes.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      doublebuffer, drawmode, gconfig, getgdesc, singlebuffer, underlay
  83.  
  84. NNNNOOOOTTTTEEEESSSS
  85.      This routine is available only in immediate mode.
  86.  
  87.      IRIS-4D G, GT, and GTX models, and the Personal Iris, support only single
  88.      buffered, color map mode underlay bitplanes.
  89.  
  90.      The Iris Indy supports 8 underlay single buffered bitplanes, if
  91.      configured with 24 bit normal color planes.
  92.  
  93.      The Personal Iris supports 0 or 2 underlay bitplanes.  There are no
  94.      overlay or underlay bitplanes in the minimum configuration of the
  95.      Personal Iris.
  96.  
  97.      IRIS-4D GT and GTX models support 0, 2, or 4 underlay bitplanes.  Because
  98.      4-bitplane allocation reduces the popup framebuffer to zero bitplanes,
  99.      however, its use is strongly discouraged.  The window manager cannot
  100.      operate properly when no popup bitplanes are available.
  101.  
  102.      IRIS-4D VGX models support 0, 2, 4, or 8 underlay bitplanes, either
  103.      single or double buffered, in color map mode only.  The 4 and 8 bitplane
  104.      allocations utilize the alpha bitplanes, which must be present, and which
  105.      therefore are unavailable in draw mode NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  106.  
  107.      Use ggggeeeettttggggddddeeeesssscccc to determine the maximum number of bitplanes supported for
  108.      the underlay framebuffer.
  109.  
  110.      Iris Indigo does not support uuuunnnnddddeeeerrrrllllaaaayyyy so ggggeeeettttggggddddeeeesssscccc returns zero for the
  111.      number of underlay bitplanes on Iris Indigo.
  112.  
  113. BBBBUUUUGGGGSSSS
  114.      The Personal Iris does not support shade model GGGGOOOOUUUURRRRAAAAUUUUDDDD in the underlay
  115.      framebuffer.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.